home *** CD-ROM | disk | FTP | other *** search
- ISA PnP utilities Version 1.18
- ==============================
-
- These programs allow ISA Plug-And-Play devices to be configured
- on a Linux machine.
-
- This program is suitable for all systems, whether or not they
- include a PnP BIOS. In fact, a PnP BIOS adds some complications
- because it may already activate some cards so that the drivers
- can find them, and these tools can unconfigure them, or change
- their settings causing all sorts of nasty effects. If you have
- (for example) plug and play network cards that already work, I
- suggest you read the manual page isapnp.conf(5) on the format
- of the configuration file very carefully.
-
- See the example for a dataflex voice fax modem and NE2000 clone
- PnP card in README.modules. See the section below on Drivers and
- MODULES for more background information. For even more hints etc
- see the FAQ at:
-
- http://www.roestock.demon.co.uk/isapnptools/isapnpfaq.html
-
- The commands have been taken from the Plug and Play ISA
- specification Version 1.0a, widely available on the net.
- (ftp://ftp.microsoft.com/developr/drg/Plug-and-Play/Pnpspecs/PNPISA.EXE -
- this is a self-extracting DOS archive of PNPISA.DOC - a
- word 6 document. If Word 6 not available, use the freely
- redistributable viewer wordview which comes on the Win95 CD).
-
- See CHANGES for a list of changes from the previous version.
-
- See README.OS2 for description of OS2 stuff.
-
- Installation intructions
- ========================
- See the file INSTALL.
-
- Format of pnp configuration file:
- =================================
- See the manual page isapnp.conf.5.
-
- If you have a problem:
- ======================
- Please start by looking at ALL the documentation provided, including
- the FAQ, then look at the isapnptools website at
- http://www.roestock.demon.co.uk/isapnptools/
-
- Drivers and MODULES
- ===================
- Note that boards first configured by isapnp are not visible to the kernel
- during boot up. This means that drivers for the boards must be loaded
- as modules after the board has been configured, so that they can
- locate the board. See README.modules for an example.
-
- This doesn't apply to serial cards, because setserial can be used to
- configure the serial ports after the kernel has booted.
-
- Also, IDE devices can be initialised after the kernel boots by
- configuring IDE-PCMCIA in the kernel. Then writing a module to
- initialise the device after running isapnp.
- See README.ide and /usr/src/linux/Documentation/Configure.help.
-
- An alternative method is to use initrd to run isapnp before booting
- the main kernel. See README.initrd and /usr/src/linux/Documentation/initrd.txt.
- This may be particularly applicable for IDE devices attached to PnP cards.
- I hope to experiment with initrd sometime for my network card...
- if you've already done it please tell me how.
-
- If you boot Linux from DOS using loadlin, you can also run the DOS
- version of isapnp before booting Linux. This would allow you to use
- normal compiled in drivers.
-
- If the kernel needs rebooting after configuration, because the drivers
- are not modules, it may be possible to do this automatically in your
- bootup scripts: use an isapnp.conf file which dumps the board
- configuration registers and tests the the output.
- If the board(s) haven't been configured, configure them with the
- configuration isapnp.conf file and reboot.
- If the boards have been configured, continue the boot normally.
- You may want to take precautions to prevent the kernel continuously
- rebooting if something goes wrong...
-
- isapnp for debugging.
- =====================
- This example shows how the PEEK command may now be used with the standard
- configuration settings to dump the actual board configuration register
- settings, for example, the script:
-
- #(DEBUG)
- (READPORT 0x3bb)
- #(READPORT 0x203)
- (ISOLATE PRESERVE)
- (IDENTIFY *)
- (CONFIGURE DFX0000/1493
- (LD 0
- (IO 0 (PEEK)) # Dump Port 0
- (IO 1 (PEEK)) # Dump Port 1
- (IO 2 (PEEK)) # Dump Port 2
- (INT 0 (PEEK)) # Dump INT 0
- (DMA 0 (PEEK)) # Dump DMA 0
- (DMA 1 (PEEK)) # Dump DMA 1
- (MEM 0 (PEEK)) # Dump MEM 0
- (REG 0x60 (PEEK)) (REG 0x61 (PEEK)) # Dump Port 0
- (REG 0x62 (PEEK)) (REG 0x63 (PEEK)) # Dump Port 1
- (REG 0x64 (PEEK)) (REG 0x65 (PEEK)) # Dump Port 2
- (REG 0x70 (PEEK)) (REG 0x71 (PEEK)) # Dump INT 0
- (REG 0x74 (PEEK)) # Dump DMA 0
- (REG 0x75 (PEEK)) # Dump DMA 1
- ))
- (WAITFORKEY)
-
- produces the following with my dataflex modem:
-
- Board 1 has Identity 6e 00 00 05 d5 00 00 d8 10: DFX0000 Serial No 1493 [checksum 6e]
- Peek(DFX0000/1493)[0][0x60](IO 0) is 0x03E8, (3,232)
- Peek(DFX0000/1493)[0][0x62](IO 1) is 0x0000, (0,0)
- Peek(DFX0000/1493)[0][0x64](IO 2) is 0x0000, (0,0)
- Peek(DFX0000/1493)[0][0x70](INT 0) is 0x0C02, (12,2)
- Peek(DFX0000/1493)[0][0x74](DMA 0) is 0x04, (4)
- Peek(DFX0000/1493)[0][0x74](DMA 0) is 0x04, (4)
- Peek(DFX0000/1493)[0][0x40](MEM 0) is 0x0000000000000000, (0,0,0,0,0,0,0,0)
- Peek(DFX0000/1493)[0][0x60](-REG-) is 0x03, (3)
- Peek(DFX0000/1493)[0][0x61](-REG-) is 0xE8, (232)
- Peek(DFX0000/1493)[0][0x62](-REG-) is 0x00, (0)
- Peek(DFX0000/1493)[0][0x63](-REG-) is 0x00, (0)
- Peek(DFX0000/1493)[0][0x64](-REG-) is 0x00, (0)
- Peek(DFX0000/1493)[0][0x65](-REG-) is 0x00, (0)
- Peek(DFX0000/1493)[0][0x70](-REG-) is 0x0C, (12)
- Peek(DFX0000/1493)[0][0x71](-REG-) is 0x02, (2)
- Peek(DFX0000/1493)[0][0x74](-REG-) is 0x04, (4)
- Peek(DFX0000/1493)[0][0x75](-REG-) is 0x04, (4)
-
- Bugs
- ====
- I haven't tested the Memory setting stuff, as I haven't
- got a card with suitable drivers. If it doesn't work, tell me,
- and work around using poke, which I have tested.
-
- The config option to pnpdump is experimental, and
- doesn't always produce non-conflicting output.
-
- Newer PCs don't always work, I now think this is due to faulty
- hardware, see the FAQ for details.
-
- Note
- ====
- These programs must run as root, as they need unrestricted access
- to the computer IO addresses. This could cause lots of problems,
- so use with care. DO NOT MAKE THESE PROGRAMS SUID root !
-
- This is particularly important now that pnpdump (with certain options)
- uses popen() to invoke external programs.
-
- Copyright
- =========
- These programs are copyright P.J.H.Fox (fox@roestock.demon.co.uk)
- and distributed under the GPL (see COPYING).
-
- If mailing patches, bug reports or comments, please put 'isapnp'
- somewhere in the subject line, and mail to isapnp@roestock.demon.co.uk.
-
- Warranty
- ========
- There is NO WARRANTY for these programs.
-
- These programs have been compiled on my machine using gcc 2.7.2.3,
- flex 2.5.4 and linux 2.0.36, with libc-5.4.44 and they seem to work
- for me.
-
- However, due to the nature of these programs, they are very likely
- to completely screw up your computer: USE AT YOUR OWN RISK. But if
- you find them useful, or have some suggestions for improvement,
- please tell me.
-
- Credits
- =======
- Thanks to the following for bug reports, fixes, improvements and
- suggestions for improvement to isapnptools.
-
- Bob Clark <rlc@hrb.com>
- Neal Sanche <neal@nsdev.ocunix.on.ca>
- Karsten Keil <pnp@temic-ech.spacenet.de>
- Jim Studt <jim@federated.com)
- Kevin Brooks <kb10@onyx.net>
- Jeff Epler <jepler@inetnebr.com>
- Markus Gutschke <gutschk@uni-muenster.de>
- Andy Sewell <puck@pookhill.demon.co.uk>
- Rildo Pragana <rpragana@acm.org>
- Richard Henderson <rth@cygnus.com>
- Kai Dupke <dupke@koma.han.de>
- Ken Walsby <kwalsby@ttransit.co.uk>
- Rick van Rein <vanrein@cs.utwente.nl>
- James S. Blachly <jblachly@ns.insolwwb.net>
- Steffen Kremser <kremser@nukunuku.swb.de>
- Adam J. Richter <adam@yggdrasil.com>
- Norbert Klasen [ELSA AG] <support@elsa.de>
- Colin Plumb <colin@nyx.net>
- Robert Ekl <rekl@megsinet.net>
- Hidetaka Hikashi <hikashi@mlb.co.jp>
- Hetz Benhamou <hetz@isdn.net.il>
- Rick van Rein < vanrein@cs.utwente.nl>
- Jeffrey Hutzelman <jhutz+@cmu.edu>
- Pavel Roskin <pavel_roskin@geocities.com>
- Eugene <bom@classic.iki.rssi.ru>
-
- See also
- ========
-
- Users of isapnptools may be interested in the pnp mailing list
- (pnp-list@redhat.com): To subscribe to the mailinglist, simply send a
- message with the word "subscribe" in the Subject: field to
- pnp-list-request@redhat.com. This list does seem rather quiet now
- though.
-
- Latest information of isapnptools is available at the time of writing
- on my website: http://www.roestock.demon.co.uk/isapnptools/. This
- includes an FAQ, and the htmlised manual pages, so please refer to this
- first in the event of any difficulties.
-
- Peter Fox
- 14-Feb-1999
-